Release 10.1A: OpenEdge Development:
ADM Reference

modifyUserLinks

Procedure that maintains a delimited list of user-defined links (that is, links that are not in the SupportedLinks list for an object), and the handles of the objects at the other end of the links.

Location: smart.p

Parameters:

INPUT pcMode AS CHARACTER

ADD or REMOVE.

INPUT pcLinkName AS CHARACTER

The link name including -Source or -Target.

INPUT phObject AS HANDLE

The procedure handle of the object at the other end of the link.

Notes:

Run from addLink and removeLink; used primarily by the linkHandles function. When addLink encounters a link that is not in the list of SupportedLinks, it defines a single SUBSCRIBE for an event of that name (see addLink). Because there are no properties where the objects at either end of a nonsupported (or dynamic) link can be stored, they are stored in this list so that functions such as linkHandles, which returns the handle of an object at the other end of a link, can keep track of what the relationships are.
This function is not intended to be run from application code.
The list is the third entry in ADM–DATA, delimited by CHR(1). Each entry in the list consists of a link name followed by CHR(4) followed by a comma-separated list of one or more handles. The list entries are delimited by CHR(3). Users should not be concerned about the specific format and location of the list, which might be subject to change; using this procedure to access the list preserves compatibility with any possible changes.